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Introduction 

March/ April 1991 ReRUN 

IT'S DISTURBING TO SEE Commodore 64 and 128 owners get short- 
shrifted time and again by the software industry. Jusl a lew years ago, 
software tides appeared for the C-64 first, and only afterwards would ver- 
sions appear for other computer systems, such as MS-DOS machines, 
Macintoshes and Amigas. 

Welcome to 1991, when new C-64 software titles appear sporadical- 
ly, and new C-128 programs are nearly extinct. By providing C-64 and 
C-128 software as primary goods, rather than as an afterthought, Re- 
RUN will do its part to eliminate disenchantment. In spite of the dwin- 
dling industry-wide software support, 1991 already looks like a banner 
year for ReRUN. We plan to continue our role as the number one 
source of Commodore 8-bit software. 

In a slight deviation from the norm, this edition of ReRUN offers 
nothing but productivity-oriented programs. This is reflected in the first 
program, which is a collection of six utilities from our March/April 
RUN, entitled Boosting Basic. Written by programmer Stephen 
Dirschauer, these utilities give your (>64 a Search and Replace function, 
help screens, a pause key, a directory displayer, a sequential file read- 
er and the ability to display 16 sprites simultaneously. 

In response to our readers 1 requests for more application programs, 
we offer Smart Shopper, better known as Super Aisle Organizer. This 
specialized 64- and 128-mode database works by allowing you to enter 
the contents of each aisle from your most frequently-shopped super- 
markets, then it generates an aislc-by-aisle lisi so that you won't miss a 
thing on your next shopping trip. 

With a name such as Super Character Editor, experienced comput- 
erists probably expect our third program lo be a font editor. Super 
( lharacier Editor is thai and more. It not only creates fonts for various 
graphic modes, but also saves all of the color attributes assigned to the 
modified fonts. 

Pitch-Memorizer is from RUN'S March/April 128 Mode column. Af- 
ter hearing a tone played for one second in duration, you must match 
the tone of the note by pressing on keys 1 through 5. Players are judged 
on their ability (. . . or lackthereof!) to reproduce a note close to the 
first note sounded. 



MAR( :i !. Al'Rll. I LIU I ■ RrRt'N i 



Bonus programs found on this edition of RcRL'N begin with ADE 
64, an ASCII disk editor. Written by Greg Radios, author of GEOS Disk 
Editor (ReRUN November/December 1990), ADE 64 is a more com- 
part machine language rlisk editor. Written in machine language for 
the C-64, ADE 64 allows you to edit disks in ASCII mode instead of 
Commodore PETSCII mode. The advantages are obvious to any pro- 
grammers who have suffered through the conversions needed when 
editing ASCII-based disks. 

Buttons, the mouse driver utility from the January/ February '91 Re- 
RUN, is used in this edition's Pop-Up Calculator. Utilizing the conve- 
nience of the Buttons program. Calculator gives your C-64 an interrupt- 
driven, mouse-controlled calculator, 

Slill looking for more C-128 programs"- 1 Look no further — here's In- 
dexer. This specialized 40-CoIumn mode database for the C-128 allows 
you to index magazine articles. Since a s-l-o-w program of this nature 
wouldn't be of much use, Indexer is written entirely in machine lan- 
guage, so it categorizes just as quickly as you can type and saves your 
entries to disk for rapid recall whenever needed. 

The final bonus program, 128 Escape Power Keys, answers the call 
for more C-128 utilities. If you program in Basic 7.0, you'll be certain 
to appreciate the nine new escape key functions this program adds to 
your C-128. 

There you have it — a no-nonsense compilation of powerful utilities 
and applications for your Commodore. Stay tuned for more in the 
May /June issue of ReRUN. 



Technical Manager 
RifN Magazine 
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Directory 



Pace Documentation 



1 Boo.sTiNr, Basic 



Smart Siioiter 



Super Character Editor 



] '. 


Pitch MtMijRi/m 


] 1 


£ ADE64 


19 


£ PoP-l> CALCULATOR 



21 £ 128 Escape Keys 

25 £ Indexer 



* — C-12N mode only 
£ — Bonus program 



Disk Filename 


File Type 


*MENU 128 


BASIC 


MENU 64 


BASIC 


SEARCH-REPLCE 


BASIC 


HELP SCREEN 


BASIC 


SEQ SCANNER 


BASIC 


DIR DISPLAY 


BASIC 


FREEZE KEY 


BASIC 


DOUBLE DISPLAY 


BASK 


SMART SHOPPER 


BASIC 


GROCERY 


SI- ( ) 


SHOPDATA 


SEQ 


BOOT OVERKILL 


BASIC 


OVLRKILL.GEX 


BASIC 


OVERKILL.ML 


ML 


* PITCH 128 


bask: 


ADE 6-1 


ML 


CALCUIATOR 


BASIC 


BIITONS.O 


ML 


( \l (.[ IATOR.IV1 N 


Ml 


MOUSE.POINTER 


Ml 


CALCPOP.O 


Ml 


CALCULATORO 


ML 


CAI.CU1ATOR.TEXT 


ML 


♦ESCAPE KEY 128 


BASIC 


* ESC KEY.ML 


ML 


* INDEXER 


ML 


* INDEXER/CEN 


BASK . 


•INDX.RUN 


ML 


* CUSTOM IZER 


ML 


[NDEXER.MI 


Ml. 
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ReRU N 



How to Load 



Loading from the Menu 

To get siartccl, C-64 users should type LOAD "MKNl' 64",8anri press the Re- 
turn key. When you gel the Ready prompt, the menu is loaded and you should 
type RUN to see a list of the programs on vnur disk. C-128 users need 011K press 
the Shift and Run/Stop keys. When all the programs are displayed on the 
screen, you can run the one you select by pressing a single key. 

Loading from the Keyboard 

If you do not wish to use the menu program, follow these instructions. 

C-64: To load a C-64 program written in Basic, tvpc; LOAD "DISK 
FILENAME",8 and then press the Return key. The drive will whir while the 
screen prints LOADING and then READY, with a Hashing cursor beneath. 
Type RUN and press the Return key. The program will then start running. To 
load a C-64 program written in machine language (ML), type: LOAD "DISK 
FILENAMES, 1 

C-128: All C-6-! programs can be run on the C-128 as long as your 
computer is in C-IJ4 mode. All C-128 programs are clearly labeled on the 
directory page. Your C-128 must be in C-128 mode to run these programs. To 
load a C-128 mode program, press the F2 key, type the disk filename and then 
press the Return key. When the program has loaded, tvpe RUN. 

Making Copies of ReRUN Files 

Many programs on your ReRUN disk have routines that require a separate 
disk onto which the program writes or saves subfiles. To use these programs, 
yon must first make a copy of the original program onto another disk that has 
enough free space on it to hold these newly written subfiles. 

It's simple to make a copy of a Basic program. Just load it into your computer 
as outlined above, and then save the program back onto a separate disk that 
has plenty of free space for extra Hies. 

Copying an ML program is not so simple. You cannot simply load and save 
an MI. program; you'll need to use a disk-backup utility program, such as the 
one on vottr Commodore Test Demo disk. 
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Run it right: C-64 



Boosting Basic 



/Jy Stephen Dirschauer 

BASIC 2.0 IS A GOOD programming language, easy to use and adequate 
for most tasks. However, when yon need extra speed and power, it's great 
to be able to call up the heavy artillery — machine language. 

Even if you don't know how to program in machine language {and 
don't care to learn), read on. This article provides six short, painless 
routines that can greatly enhance your Basic programs. They will, 
among other things, allow yon to display 16 sprites, and add an auto- 
matic help screen and a pause/continue key to Basic. 

1 . Memory Mastery 

Memory Search & Replace, when activated, searches through mem- 
ory to find occurrences of a given byte and replaces them with anoth- 
er. The syntax is simple: 

SYS 50555,stait address.end of address+1, search byte, Replacement byte 

For instance, if you wanted to search from location 49152 to 50000, 
replacing all appearances of with 255, you would enter SYS 50555, 
49152,50001,0,255. (Note that the second parameter is the last address 
plus one. So you use 50001 and not 50000.) 

This routine has special uses, but its real strength lies in its power to 
do character animation. By searching through screen memory (where 
your C-64 keeps track of its text display) from 1024 to 2023, you can ex- 
change groups of characters at great speed. If you've redefined the de- 
fault character set, you can achieve impressive results. Just remember to 
search for the characters' screen codes, and not their PETSCII codes. 
Check your C-64 owner's manual for a list of both. 

Search and Replace is a Basic loader that pokes Memory Search & 
Replace into memory. You can include it in your own programs as a sub- 
routine. 

2. Help Available 

Man\' commercial programs tout the instant help screens they make 
available to perplexed users. Help screens are a fantastic idea, but dif- 
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ficttli to implement. If you want the help screen to be available all the 
time, it's necessary for the computer lo constantly check the keyboard 
(never mind the hassle of putting up the screen and restoring the old 
display), thereby slowing down your program. However, there is an 
easier way, using Help Screen. 

Through the interrupt request (IRQ) vector, Help Screen provides 
a key-activated help screen that's always available. Once die machine 
language part has been loaded and activated, you don't have to do a 
thing. What's more, installing it takes only two steps. 

First, create your help screen using Print statements. Help Screen 
recognizes the help screen's default starting address of 12288 by using 
FORK 648,48. Any and all characters are available for (he help screen, 
however color is not. When you've finished creating your help screen, 
restore the Print statement with POKE 648,4 and a Print command. You 
shouldn't see anything happen, because while you created the help 
screen, the olcl display was preserved. 

The second step is to activate die machine language routine with SYS 
5(1618. Press the F7 key at any time to view the screen and any other 
kc\ in exit. 

I use Help Screen during programming to keep a copy of the cur- 
rent disk's directory handy. To use it. switch the Print command (POKE 
648,48), get a list of files on the disk and reset the Print command 
(POKE 648,4: PRINT). This can save time when checking for filenames. 

3. Sequential Scanner 

Reading text files from disk in Basic is possible, but it's also painful- 
ly slow. So slow, in fact, that you'll probably want to do it in machine 
language. The program SEQ SCANNER not only reads the files, but 
wails for a key press after every page of information. 

Before you can activate SEQ SCANNER, you must open the file us- 
ing channel 1. For example: 

OI'KN 1, N/J, 'OM'ROGRAM. DOCS, M,R" 

The M after the filename tells Commodore DOS to ignore the filctype 
and open the file, whether it's program, sequential or user. Now activate 
the machine language reader with SYS50682,|number of lines). 

The lines parameter is the vertical size of the screen. Most of the time 
you'll probably use the default screen size of 25 lines, but anything from 
to 255 is acceptable. An interesting value is 1, which makes you stop 
after every line when reading. (A line of text is considered a group of 
i haracters followed by a carriage return.) You can then press a repeat- 
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ing key (such as the space bar) to keep the display going. Pressing 
run/stop at any time aborts SEQ SCANNER. 

4. Directory Display 

You can also display a disk directory in Basic, but once again, it's too 
sluggish. Still, if your program asks for filenames at all, a directory list- 
ing is a must. DIR DISP1 AYprintsa list of centered filenames from disk, 
discarding the seldom-used (from within a program, at least) file size 
and type. As with SEQ SCANNER, open a file to read the director)'. You 
can then SYS 50764 to read the file. Finally, don't forget to close the 
file when you're done. For example: 

( )1*FN 1 ,H,0,"$":SYS50764:( ILOSE I 

You can use Commodore DOS wildcards for selective lists of files, as 
shown in Table 1. Pressing the Run/Stop key will hall the display. To 
pause the directory, just hit any other kev. Hitting an additional key will 
make it continue. 

5. Freeze Key 

The Display Directory routine pauses with the press of a key, but what 
about the rest of your program? If you need to print a great deal of in- 
formation ,ii one time, an option to pause output is essential. I louevei , 
as with the help screen, it's impractical to check the keyboard at every 
chance. Freeze Key uses the IRQ vector to add an automatic pause key 
to your C-64. Again, once it's installed and activated, you don't have to 
do a thing. SYS 50960 will make the routine work behind the scenes. 
When the Control and P keys are pressed, everything will freeze and the 
border color will change. Press another key to continue. 

6. Seeing Things? 

Sprites are undoubtedly the best feature of the VIC-II graphics chip. 
The only problem is the limit of eight. However, Double Display in- 
creases the number of available sprites from eight to 16. Just call up 



Table 1. Using wildcards to display files with 


Display Directory. 


Statement 




Function 










OPEN! ,8,0, 


'S*=S" 


Lists only 


*r(|urntial files 








( >PEN 1 ,8,0, 


'SDATA 


*■■ 


I.isis only files with 


a "DATA. 


prefix 


OPEN 1, 8,0, 


'$A*=P" 


Lists prog 


■am tiles beginning 


wilti A 
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the Double Display routine at the beginning of your program with SYS 
/i 101 8, split point. 

Though Double Display does give you lf> sprites, each with individ- 
ual characteristics, there's a catch: The screen is split in two, with eight 
of the sprites in the lirsl portion and eight in the second. It may be help- 
lul to think of the two halves as different screens. Fortunately, yon de- 
cide where to split the screen. Set the split point to anything from to 
255. For a split point in the middle of the screen, use 150 (the first vis- 
ible screen line is number 49), 

You'll have to use new sprite registers, since the old ones can only 
handle eight sprites. Just keep in mind the limit: Sprites can't escape 
their respective sunscreens. In fact, they should slay at least ten pixels 
away from the borderline separating the two. 

See Table 2 for more detailed information. All Double Display reg- 
isters emulate the old V1C-II sprite registers, so the same values must 
be supplied for twin sprites. For example, to turn on sprite 1 and po- 
sition it at fi5,7f), enter: 

POKE 51273, l:POKE 51248,65:POKE 51249,70 

To turn on sprite 10 and place it at 175,100, enter: 

POKE 5131 3,2:POKE 5 1 290, 1 75:POKE5 1 29 1 , 1 00 



Table 2. New 


sprite registers for 


use with Double Display. 




Screen I 


Screen 2 


VIC11 




Description 


51248-5126:1 


51288-51 303 


53248-h! 


i3263 


)C/Y locations 


51264-51271 


51304-51311 


2040-2047 


Inuur pointers 


5 1 272 


51312 


53264 




L -LSI bit of X jKisilioii 


51273 


51313 


53269 




Sprites enabled 


51274 


51314 


53271 




Vertical expansion 


51275 


51315 


53275 




Priority register 


51276 


51316 


53276 




Multicolor or hi-res 


51277 


51317 


53277 




Horizontal expansion 


51278 


51318 


53285 




Multicolor register 


51279 


51319 


53286 




Multicolor register 1 


51280-51287 


51320-51327 


53287-: 


32114 


Sprite color registers 



4 RtKlS 
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Here's a tip: Set variable VI to 51248 and variable V2 to 51288. You 
can then refer to registers as Vl+X and V2+X. Not only does this save 
on typing, but it's easier to remember. In the last example, you would 
need to type only: 

POKE V2+25,2dPOKE V2+2, 1 75:POKE V2+3, 1 00 

Although the V1C-II chip can only handle eight sprites at a time, 
Double Display gets around this limitation by using the eight sprites 
twice. To understand how, consider the way a television set or computer 
monitor displays a picture. Sixty times a second (50 on European PAL 
systems), an electron beam, called a raster, redraws the screen display. 
The beam does this by drawing one pixel-high horizontal line after an- 
other as it scans down (he screen. 

Only 200 of these scan lines are visible, the first one being number 
50. (You'll find that these are the same lines used to position sprites ver- 
tically.) Memory location 53266 in the C-64 keeps track of the current 
line being drawn. Basic is much too slow to take advantage of this, but 
Double Display, written in machine language, can easily use it. 

When the lop portion of (he screen is being drawn, Double Display 
takes the first eight sprites' registers and copies them to the VIOH's own 
memory, then waits until the first portion of the screen is finished. 
Next, it copies the following eight sprites' registers into V1C-I1 memo 
ry and wails for the electron beam to return to the first line and start 
again. The gullible V1C-II chip is fooled into displaying each of its 
sprites twice; the ninth sprite is really the first, and so on. 

Parting Words 

Two final points: First, three of the six routines (Help Screen, Freeze 
Key and Double Display) use the C-64's IRQ vector. They are compat- 
ible with each other, so you can use all three at the same lime. On the 
other band, you may encounter trouble using them with other pro- 
grams thai bog the IRQ vector. If this happens, install the other rou- 
tines first, and then install anv of the three routines jus! mentioned. 
These routines share the vector with the program preceding them, 
thus this should eliminate any conflict. 

Second, if you're a budding machine language programmer, you 
may be interested in disassembling the code for any of the routines. 
Looking al short, working code is a great way to improve your skills. 
■While doing this, keep a good reference book handy to save time; any- 
thing with a comprehensive memory map of the C-64 will do nicely. 
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RUN il right: C-64 or C-128 (in 40- or 80-Column mode) 



Smart Shopper 



Hy Alan Brail foul 

HAVE YOU EVER walked into a supermarket with a shopping list, 
pushed your carl up and down the aisles selecting cans and boxes, and 
then waited half-way through the check-out line . . . only to realize you 
hadn't picked up (he stuffed artichokes? They were right there on the 
list, two items from the bottom, but you missed them because stuffed 
artichokes are in theirs/ aisle, not the last. Use Super Aisle Organizer 
and it will never happen again! 

Super Aisle Organizer is a specialized database program that lets 
you browse through a list of items you usually buy on your weekly sa- 
fari to the supermarket and select the ones you want on (he current 
trip, then print out a list of (hose items organized by aisle. You won't for- 
get anything, and you won't have to retrace steps for things you missed. 

The program is written entirely in Basic and uses two sequential files 
for the item, aisle and store data. Yon can include tip to 500 items and 
five stores (the same items for all stores) in your master list. 

After loading the program using Menu 64 or 128, it's a good idea to 
save all of your changes to a formatted work disk for future reference. 
The program's Main menu offers the following three options, plus 
Quit: 

The Shopping List option lets you select a store and items to buy, then 
prin( out a shopping list. When you choose a store, the master list of 
items will appear on the screen. Press the space bar to move the cursor 
down to the next item, press C to go to the second column on the page, 
and press N to go to the next page. To select an item, press the Return 
key, then respond to the prompt for quantity by pressing return again 
for one, or by typing a number and pressing return for more. 

You can print out a list at any time. It will show the store name at the 
top, then the items under their appropriate aisles. 

The Edit List option lets you add items and stores to your master list 
and make any needed changes. It will also make a printout of an in- 
complete master list that you can take to the store with you so that you 
can fill in aisle numbers. 

To add an item to the master list, type its name and aisle number 
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( 1 5 characters maximum) for each store. If you don't know the aisle at 
a certain store, enter 0. If an item isn't available at one of the stores, 
enter 99 for the aisle. Number 98 is for the aisle along the back wall of 
a store. When you're done, press £ to return to the Edit menu. 

To alter item and store names or aisle numbers, choose the appro- 
priate Edit menu option and follow the prompts. 

When you're ready to print out your master list, select the Edit menu's 
print option. The items will appear in alphabetical order, along with 
aisle numbers for all stores. 

After you're done making additions or changes, return to the Main 
menu and the new data will be saved to disk automatically. 

flu- Main menu's New Disk Setup option creates two data files, Gro- 
ccw and Shopdata. on a freshly formatted disk. It's a good idea to save 
a copy of the program on this disk, too. To make backup copies of the 
data files, open the Edit Items menu, swap to the data disk, and exit 
the menu: the data will be written lo the new disk, Finally, save a copy 
of (he program lo the data disk as well. 

Now, thanks to your trusty Commodore computer, you'll never go 
without stuffed artichokes again! 



RUN it right: C-64 

Super Character Editor 

By Rotco Saya 

WITH OVER 30 FUNCTIONS, Overkill is a character editor with a 
professional look and feel that experienced programmers will iind use- 
ful. Overkill simplifies the process of redefining characters that can be 
used in any of the C-(iTs graphic modes. Because there are over 30 func- 
tions in the program, but no menus, learning lo use it proficiently will 
take time. However, 1 expect thai you'll soon come to enjoy it as much 
as I do. 

To use Overkill, load it using Menu 64. Be sure to have a formatted 
work disk handy to save your edited character sets on. 
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Getting Started 

When the split screen appears, you'll notice that the top window is for 
actual editing. Here, all important registers are displayed, along with an 
eight-by-eight pixel area where you ran redefine characters. 

The bottom window displays an entire character set. You'll also no- 
tice right away that the bottom window is full of junk. Don't worry — 
it's just static memory. 1 kept the junk out of the top window by using 
a raster routine that displays separate charac lei graphics pages at the 
lop and the bottom. Any work you do on your page at the bottom 
won't affect the display at the top. In this way, you'll never be working 
without being able to see what you're doing. 

Overkill will let you edit characters in either multicolor or hi-res for- 
mat. In addition, it provides four separate character graphics pages for 
you to work oil. 

To minimize confusion, the first time you use Overkill press F5 and 
answer Y to the prompt. The bottom window will contain the normal 
Commodore character graphics. Now thai things look a little better, no- 
tice that your cursor is in the bottom window around the letter a. Use 
the cursor keys to move anywhere in the bottom window to pick a char- 
acter. There are two other cursors in the bottom that I'll explain later. 

To exit Overkill, press the Run/Stop and Restore keys simultaneous- 

iy- 

Editing Commands 

Foi ( herkill to function properly, some commands are available only 
in the top or bottom window. If there's no other indication, a command 
is available in both windows. 

Choose a character to edit. Place your cursor on I he desired character 
and press Fl . The bottom cursor will disappear and another cursor will 
appear inside the eight-by-eight pixel editing area in the top window. 
Now you can use the cursor keys to move this cursor around. To get 
back to the bottom window, press Fl again. 

Hi-res editing. Press the space bar to toggle a single pixel on or off, 
Top window only. 

There are four multicolor editing commands. These are available in 
the lop window only. They are: 

Plot bit pattern 01. Press 1 and Multi 1 is displayed at the top-right. 
This is also the Background Color I register (53282, or $D022) used 
in multicolor mode. 

Plot bit pattern 10. Press 2 and Mulli 2 appears at the top-right. This 
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is also the Background Color 2 register (53283, or $D023) used in mul- 
ticolor mode. 

Plot bit pattern 11. Press 3 to display color RAM at the top-right. Mul- 
ticolor characters use the actual screen color of a character for this bit 
pattern. 

Plot bit pattern 00. Press and the background color is displayed at 
the top-right. It just erases a pixel using the actual Background Color 
from register 5328 1 , or $D021 . 

Note that in Multicolor mode you lose half the horizontal resolution 
available on the C-64, because the C-64 needs extra information to be 
able to display multicolor characters. Therefore, in Multicolor mode 
you'll plot two pixels at a time, horizontally. 

Switching modes. To toggle between Hi-Res or Multicolor mode, 
press M. This affects the bottom window only. When incorporating a 
character graphics page into your own program, you must use register 
53270, which is a control register. To make your character graphics 
page multicolor, use POKE 53270,PEEK(53270)OR16. To make it hi- 
res" again, use POKE53270,PEEK(53270)AND239. 

These commands are for changing the Four color registers: 

Change multicolor mode 1. Press F2. 

Qwnge multicolor mode 2. Press 1*4. 

Change color RAM. Press F6. 

Change background. Press F8. 

Pressing these keys allows you to cycle through the available colors. 
Keep pressing the appropriate key until you get the color you want. 

Be aware that when you're in Multicolor mode, color RAM must stay 
at eight or below to be displayed properly. If it's above eight and you 
switch to Multicolor, the color RAM will automatically change to eight 
less than its current value. 

Also note that the value of color RAM in the bottom window is actu- 
ally eight more than indicated. For a character to be displayed in mul- 
ticolor, its screen color must be higher than seven. If it's not, the char- 
acter will be displayed in hi-res. In this way. the C-64 can display 
multicolor and hi-res characters simultaneously in Multicolor mode. 

Just remember that when you want to display a multicolor character, 
you must make sure its screen color is between eight and 1 5. Also, even 
though its screen color is above eight, its color RAM nibbles will be 
shown as a value of eight less than the screen color. 

Erase a character. Press clear/home to erase the current character. 

Rotate 90 degrees. Press > to rotate a character 90 degrees clockwise. 
Note thai this causes strange results to occur in Multicolor mode. 
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Mirror horizontally. Press shift/ R to produce a mirror image of a char- 
acter in a horizontal perspective. 

Mirror vertically. Press F to produce a mirror image of a character in 
a vertical perspective. 

Reverse video. Press R to create a negative image of the character. This 
results in some blurring in Multicolor mode. 

Copy character into buffer. Pressing I puts the current character into 
the character buffer. 

Replace character with buffer. Pressing O replaces the current charac- 
ter with the contents of the character buffer, copying a character. 

Replace character with ROM image. Pressing F8 replaces the current 
character with the default ROM image. 

Show data. Press D to display the Data statements that define the 
character. Bottom window only. 

Scroll character. Press the Back Arrow («— ) then the Cursor keys to 
move the current character bit by bit in any direction. When in Multi- 
color mode, scroll left or right twice to achieve proper results. When 
you scroll a character, all pixels will wrap around. To toggle in and out 
of this scroll mode, press <— . 

Change page. Press P. Overkill lets you work on up to four separate 
pages. Here is a list of them, their memory locations and the appro- 
priate pokes for the VIC chip memory control register, which resides 
at memory location 53272. 

Addresses Pokes Addresses Pokes 

B192-102S9 POKE 53272,24 12288-14335 POKESS272,28 

102.10-12287 POKE53272.26 14436-16383 POKE5S272.30 

For your own program to displajy your character graphics page, you 
poke a value into location 53272, for the page invoked. To get the de- 
fault character graphics back, POKE 58272,21. Remember that these 
pages are independent of one another, and normally you can use only 
one at a time. I say "normally," because with Overkill it is possible to 
have more than one character graphics page on the screen at once. 
However, it's beyond the scope of this article to explain the raster in- 
terrupts required. I'd recommend the book Mapping the Commodore 64 
& 64Cby Sheldon Leemon, a Compute! books publication, flu- follow- 
ing four commands are lor manipulating an entire character graphics 
page. For your program's safety, a prompt will ask if you're sure you 
want to issue the command. They are: 

Copy entire page into page buffer. Press shift /J to put the entire current 
page into the page buffer. 
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Replace mtire page zvilh page buffer. Pressing shift/O replaces die en- 
lire current page with the contents of the page buffer. 

Replace entire page with character ROM. Pressing F5 replaces the en- 
tire character page with the default characters. 

Erase entire page. Pressing F7 erases the enure character page. 

Disk Operation Commands 

The rest of Overkill's commands deal with disk operations. If an er- 
ror occurs while you're accessing your chive, the program reports it. 

Before describing the disk commands, I should mention that a page 
save occurs within a specified range of memory, defined by beginning 
and ending markers. The default for start-of-range is zero and the de- 
fault for end-of-range is 255. With the default settings, the Save com- 
mand will store the entire current character graphics page. However, 
the first two disk commands will let you alter the range, so you can save 
any portion of the current character graphics page. Alter any disk ac- 
tivity is complete, the start and end ranges of a page default back to their 
original values. 

You can view the range in either half of the screen. In the top half, it's 
represented by the two numbers labeled "Range." In the bottom half, use 
those two mysterious cursors. Just move the first cursor to the position 
desired for the start and the second cursor to thai desired for the end of 
range, then press die appropriate key. The disk commands are: 

Set start of range. Press the + key. Bottom window only. Marks where 
you want to start saving your characters. 

Set end of range. Press the - key. Bottom window only. This marks the 
slop position for a save. 

Save data. Press S. The screen will clear, turn color and request a file- 
name. Make sure a formatted work disk is in the drive, enter a filename 
and press return. If you try to save your character graphics with a file- 
name that exists, the program will ask if you want to replace that file. 
If yon answer Y, it scratches the old file and saves the new one. 

Load data. Press L. The screen will clear, turn light blue and request 
a filename. Enter the filename and press return. Note: Overkill makes 
no provision as to the load address — therefore, the file will load into 
another application at the default memory from which it was saved. 

When you are entering the filename for a load or save, you can press 
run/stop to abort the operation and return to the Main menu. 

After you use the Load or Save command, several pointers will default 
to their original values. They are: color RAM, both start and end of range, 
mode, and current page. If you loaded data into Overkill using the Load 
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function, just change pages to find your diameter graphics. 

Final Tips & Reminders 

Overkill resides in memory from location 1(5381 to 20889- and uses 
locations 28672 to 30720 for variables. Consequently, you could use oili- 
er machine language utilities at I he same time, since these areas of 
memory are rarely occupied. Be aware, however, that a long Basic pro- 
gram could cut into Overkill, so be careful when running multiple pro- 
gramming utilities. 

As a programming trick, you could use a small Basic program with 
Overkill to test your characters in action. To reactivate Overkill from 
Basic, just enter SYS 16384. 

Remember that you must use control register 53272 to actually use 
your character set. Also, if you plan to use multicolor characters, you 
must use register 53270. When using multicolor characters, he sure to 
use registers 53282 and 53283, poking these with the colors yon want. 
And finally, to load your character graphics data into memory, re- 
member to enter LOAD "NAME",8,1. 



RUN it right C-128 



Pitch Memorizer 



By Mark Jordan 

A RECENT VISIT with my family to the Chicago Museum of Science 
and Industry planted a new programming idea in my head. In the 
Sound exhibit we had a lot of fun playing with a machine that measured 
our ability to memorize and then match an audio pilch. 

The process was simple. Wearing earphones, we listened to a tone for 
a few seconds. Then it stopped and we heard a new tone al a different 
pitch. Our object was to turn a knob that raised and lowered the sec- 
ond pitch until it matched the first. When we had the second tone just 
the way we remembered the first, we pressed a button to see how close 
we came. It was fun — especially when we were correci! 

I remember playing with this same machine over a decade ago, bul 
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a decade ago I knew nothing about computers, oscillators or the Sound 
statement, and little about pilch frequencies. After this visit, it struck 
me how simple i( would be to program this sort of pitch-memory de- 
vice for the C-128. 

The Program 

The following program, Pitch-Memorizer, is the result. Just load it 
from disk using Menu 1 28. Pitch-Memorizer is almost as easy to use as 
the machine at the museum, although you will control the pilch by 
pressing keys rather than by twisting a knob. 

The number 4 and 5 keys both raise the pitch. The 4 key raises the 
pitch in large steps while the 5 key moves it in small increments for fine- 
tuning. Number keys 1 and 2 are similar; the 1 key lowers the pilch in 
large steps, the 2 key in small increments. This lets you move quickly 
to the approximate pilch /.one with the I and 4 keys, then fine-tune with 
the 5 and 2 keys. When you think your tone matches the first, press re- 
turn to see how well you remembered. 

You will enjoy testing your pitch memory with this program, but that's 
not the only reason I presented ii this month. I also wanted to illustrate 
die value of keeping your programs small. Pitch-Memorizer, a 32-liner, 
was neither time-consuming nor difficult. It took less than two hours to 
write. With the C-128 Sound statement, programming the sounds was a 
snap, even if a tad crude. CHAR, GET-KEY and DO/ 
LOOP are other C-128 features that saved time and frustration. 

I'm a strong believer in short programs. By keeping the program sim- 
ple, I enjoyed writing it as much as using it. Pitch-Memorizer is short 
enough that I didn't even need to pre-plan il or add comments for fu- 
ture reference. I just began at the lop and wrote it. Done. At Fin. What's 
more, the main structure of the program is complete, so it will be easy 
to modify. I envision a refined, animated future version with more pre- 
cise controls, more options and more tests. 
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ADE64 

By Greg Badros 



WITH A GOOD SECTOR EDITOR you can inspect, edit and change 

every byte on a disk. Unfortunately, standard Commodore disk editors 
aren't very useful for editing ASCII disks. Because most Commodore 
disk editors support only Commodore PETSCII, rhanging the text mes- 
sages in the true ASCII becomes nearly impossible. ADE 64 solves this 
and other problems, to make editing GEOS and other ASCII disks a 
breeze. 

ADE (')■! is compatible with all printers that accept 1'F.TSCII characters 
and all Commodore disk drives, including the 1581. Pressing U toggles 
between devices 8 and 9, so you can choose the drive you want. 

To use ADE 64, load and run it just like a Basic program using Menu 
64. Then place a work disk in the drive, press Return, and enter the 
track and sector you want to work on. 

Background 

Commodore disks are divided into numerous tracks, which are, in 
turn, divided into sectors. The number of tracks per disk and sectors 
per track varies with (he type of drive. Each seeior (also called a block) 
contains 256 bytes of information stored there- by the computer. With 
ADE 64, you can inspect and change each byte of any sector. 

The first two bytes of each sector serve a special purpose: They point 
to the next track and sector in a sequence of blocks (hat belong to- 
gether. This makes it possible to have files as long as needed. 

For instance, track 18, sector (or 40,0 on a 1581 disk drive) is the 
directory header. It cot i tains the BAM (block allocal ion map), die disk 
name and some other information. The fust two bytes of that sector 
contain track and sector values for the next directory block. That block, 
in turn, contains the information for the first eight files on the disk, 
along with, in the first two bytes, another link to die following sector 
of the director)'. The end of a file, or chain of sectors, is signified by a 
track pointer of in the first byte of the sector. 

Sectors in tracks other than 18 usually contain the actual data in a file. 
You can edit these blocks, also. In fact, with ADE 64 you can edit any- 
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thing on a disk, including directory entries, Basic programming and even 
text within a GF.OS application. The possibilities are endless. 

The Screen Display 

The editing screen is divided into two main sections and several sub- 
sections. The top half of the screen contains the block-contents window; 
the bottom half contains oilier information you'll need to intelligent- 
ly edit the current sector. When yon press the help (£) key, the bottom 
of the screen will switch to a list of editing commands. All values are 
given in both decimal and hexadecimal. 

Moving the Cursor 

Once a block has been read in and displayed, a flashing cursor ap- 
pears in the upper-left corner of (he block-contents window. To edit the 
bytes you want within the sector, move the cursor to the proper posi- 
tion. The four cursor keys behave normally, except that the cursor will 
wrap right/left and top/bottom. 

Several other keys also move the cursor. The space bar acts like the 
cursor-right key, except it always moves to the next position in the block. 
For instance, at the right of the block-contents window, cursor-right 
moves the cursor to the far left of the same line, but the space bar moves 
it down one line as well. Delete is the opposite of space. It moves the 
cursor to the left and up one line, if necessary. Both Space and Delete 
wrap between positions and 255. The Home key works as usual, re- 
turning the cursor to the upper-left corner of the block-contents win- 
dow. The last special cursor control is Shift/Return. This combination 
returns the cursor to the left end of the current line. Once the cursor 
moves, all information is updated lo reflect the new position. 

The Commands 

ADE 64 includes many commands to simplify the disk editing pro 
cess. All of the commands that require numerical input accept both dec- 
imal and hexadecimal values. Just press return after typing in the num- 
ber, and be sure to precede hexadecimal numbers with $. To abort any 
command, press Return without entering a number. 

F1/F2 Increments/decrements the track number. Note that these 
commands don't read in the sector (see F5/F6). 

F3/F4 Increments/decrements the sector number. These commands 
don't read in the sector either (see F7/FK). 

F5/F6 This is the same as F1/F2, but they do read die block after 
changing the (rack. 
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F7/F8 The same as F3/F4, but they do read the block after chang- 
ing the sector. 

R Reads into memory and displays the information from the block 
al the track and sector currently listed. 

W Writes the block to the track and sector currently listed. Yon must 
use this command to save any changes you've made in the block-con- 
tents window before editing a new block. 

U Toggles the disk drive device number currently in use. 

C Changes disks. ADE 64 prompts you to insert the new disk, then 
enter a track and sector to be read and edited (see the S command). 

P Inputs new text at the current cursor position in the sector. AJ1 key 
presses are stored as Commodore PETSCII values. Pressing return ex- 
its this mode. 

T The same as the P command, except all key presses are stored as 
tine ASCII for use with GEOS programs. Return exits this mode also. 

Q Quits editing and returns to Basic. 

J Reads the block pointed to by the track-and-sector link under the 
cursor and jumps to the next block. For instance, in a GEOS directory 
entry the two bytes after the filename hold the track and sector of the 
file header. By positioning your cursor at the first of these bytes and 
pressing |, ADE 64 will automatically read in the file header. 

+ Reads the block pointed to by the next-sector link information at 
the beginning of the current block. 

S Changes the sector alter you enter a new track and sector. The block 
is automatically read and displayed. Use the function keys if you don't 
want the block to replace the current sector in memory, 

O Sends the currently displayed block to the printer. Press return to 
start printing the block and any other key to abort. The printout will 
show a hexadecimal position within the block, followed by 16 consec- 
utive hexadecimal values from the sector and the true ASCII charac- 
ters they represent. 

N Reads the next block in the list of sectors accessed. If you haven't 
used the P command, or are at the end of the list, N works like the + 
command. See the section below on the list of accessed blocks. 

L Reads the block that was read just before the current block. Mere 
too, see the section below about the list of accessed blocks. 

D Sends a command to the disk drive. ADE 64 will send the com- 
mand, then read and display the error channel. Note that you must 
send a uO>ml command to switch a 1571 to double-sided mode and a 
i i()>m() command to switch bark to single-sided mode. 

B Changes a single byte value. You'll be prompted to enter a value 
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In si ore at the current position. After you change the byte, (he cursor 
will advance to the next position. 

A Changes a two-byte address value. This command works just Hke B, 
except it changes two bytes and moves the cursor two positions to the 
right. 

H I hints for a string of values. This is ADE 64's most advanced com- 
mand, and probably its most useful. See the Hunt mode section below. 

The List of Accessed Blocks 

Two of the above commands, N and L, control an ordered listing of 
accessed blocks. Every time a sector is read in, ADE 61 remembers 
which sector it is and which track, it's in. Then, after you've read in an- 
other block, you can reread I he first by just pressing L for "Last block 
accessed." You can then continue pressing I. to (race back through the 
blocks that you previously accessed, or press N for "Next block." 

It's possible to step back and forth through as many as 45 blocks us- 
ing I he L and N commands. However, if you step back too far, ADE 64 
will report a disk error and you'll have to enter a new block number. 
Changing disks or toggling the device number clears the list. 

Hunt Mode 

ADE 64 has many useful features, but the Hum command is definitely 
its most powerful. When you press the H key, the bottom message box 
asks what you want to do. To abort Hunt mode, press Return and the 
question will disappear. Otherwise, you have two options: hum for a 
string, or set the Hunt mode. 

To hunt for a string, you must choose the type of string. You may en- 
ler a string of ASCII characters (press A), a siring of PETSCII charac- 
ters (press P), a sequence of bytes (press #). or whatever you hunted 
for last (press N, for next occurrence) . Once you make a selection, ADE 
64 will hunt starting from the current cursor position. If it can't find 
the desired string in the current block, it will automatically continue 
looking in the next block. If the hunt is successful, the cursor will ap- 
pear at the start of the area you sought and a "Found!" message will be 
displayed. If it's unsuccessful, a "Not Found!" message will appeal'. 

Setting the Hunt mode is also easy. After pressing H, press F (for file) 
if you want ADE 64 to follow the track-and-scctor links in the first two 
bytes of each block, or press D (for disk) if you'd rather go sequential- 
ly through each sector on the disk. The File mode ends when a track- 
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link of is found; the Disk mode ends at the end of the disk. 

An Example 

Let's edit a text message in gcoPaint to demonstrate several functions 
of ADF. 64. After running the program, place in your disk drive a 1541- 
formalled work disk with a copy of geoPainl on it. Then enter 18 arid 

when prompted for the track and sector. You'll see the block type "Dir. 

1 leader" appear, along with the screen codes for each of the '256 bytes 
in track 18, sector of the disk in device 8. 

Since we want to change information stored in gcoPaint, we must first 
find its director} 1 entry, which will tell where on the disk the data for 
gcoPaint is stored. Before doing the search, however, we must set the 
editor to File I hint mode, so press H and then F. Now press H to hunt, 
then A for an ASCII string search. When prompted for the siring, en- 
ter GEOPAINT {notice it's all capital letters). 

Since we set the search to File mode, the track-and-sector links will 
be followed through the entire disk directory. In fact, each successive 
sector that ADF 64 loads will he displayed on the screen. Before you 
know it, your cursor will be sitting on the C of CKOPAIN T, the ASCII- 
string display area will show the complete filename, and the message 
box will tell you the string has been "Found!." 

Next we waul to go to the place on the disk where the program and 
text for gcoPaint is stored. To do this, move the cursor left twice. Now 
it's on the two-byte link to the VLIR index block for geo Paint, Press | 
to jump to that block. 

This new block contains a lis! of two-byte block pointers. F.ach pair 
of bytes, starting at position 2, is a Irack-and-sector pointer to a record 
in the file. Usually, the first of these records will have any text you 
might want to change, so move the cursor right to position 2 and press 
] again, to go to the first block in that record. 

Now we're ready to decide which text to change. It's much easier to 
shorten a message than lengthen it, so, for the sake of this example, 
we'll change "update" in the File menu to "save." First we have to find 
where "update" appears in the record. Remember that ADF, 64 is still 
set to File mode, so press H followed by A to hunt for an ASCI] string 
again. This time enter "update" (all lowercase letters) and wait a minute 
or so as the editor searches for the suing. When it's been found, your 
cursor will appeal' on the "u" in "update," 

Next, press T to enter ASCII text at the current cursor position, type 
in "save", and press return. Since "save" is two bytes shorter than "up- 
date", you'll need to show CEOS that the menu text ends after the "e" 
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by using the B command with a value of 0. This null signifies the end 
of the string. After doing all that, press W to write the modified sector 
hack to disk. Now, whenever you use dial copy of geoPainl, "save" will 
appear in the File menu instead of "update." Try it and see! 

Remember, you don't need to limit yourself to changing menu choic- 
es. Try editing the deskTop messages that appear in dialog boxes, or 
even the high-score list in your favorite arcade game! 

Closing Notes 

ADE 64 is a powerful program, but with power conic hazards. Writ- 
ing a sector with just one wrong byte could erase an entire file (at least 
until the wrong byte is lixed). Yon must be very careful when editing a 
disk. In fact, you should make a backup copy of the disk you want to 
edit before changing anything. 

When editing disks, it's important to know which bytes in which sec- 
tors are particularly important 1 suggest that you have a copy of Inside 
Commodore DOS handy for reference while you're working. You should 
also have The Official GEOS Programmer's Reference Guide nearby when 
editing GEOS disks. 
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The Pop-Up Calculator 

By Kevin Smotherman 

f'.VF.RYOXK I IAS A I !( )BBY. Some people climb mountains, othei s col- 
lect tilings, but me? I just lose stuff — my calculator for example. It al- 
ways disappears just when I need it most — like wliiie I'm running a pro- 
gram and need to do some calculations. To end my woes, 1 finally wrote 
Calculator, a mouse-driven machine language program that puts the 
power of the C-fi4's built-in Basic math functions just a SYS away. 

Calculator operates in the environment created by Buttons, which ap- 
peared in the January/February 1991 issues of /JEW and RcRL'N. But- 
tons lets you program a mouse-driven, object-oriented input system 
that's very easy to use. 

Calculator is completely self-contained, usable in any environment 
and works in "pop-up" mode. When you start it with SYS h.HOOO, it saves 
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the current screen, color RAM and stains of the Buttons environment, 
then pops up on the screen. When you're done with your arithmetic, 
point and click your mouse on the off button, and instantly your video 
and button environments will be restored. 

Program Operation 

To use Calculator, just select the "Calculator" option from Menu 64. 
The program automatically loads and initializes the Buttons driver, 
and saves and restores the buttons environment when you exit. That 
means that the description window parameters at 690-693 and the 
table vector at 833, 834. You'll note that the last selected Button byte 
(at 679) and the current table number to activate (at 680) are not 
maintained, so restore them after a Calculator call. 

The power of Calculator comes from Basic itself. Calculator builds 
a tokeni/ed buffer from your key presses. Then, when you press the = 
key, it calls the Basic expression evaluator to do the computations. Just 
use the exact Basic syntax that you would if you were coding the ex- 
pression and all will go well. 

Calculator's display window is limited to 24 visible characters, but you 
can input up to 128 characters for evaluation. The filled-in circles on 
either side of the display window let you scroll in either direction, al- 
though if you scroll to the left and then attempt to add to your ex- 
pression, Calculator will automatically move back to the far right-hand 
end so you can sec what you are doing! 

Special Functions 

The CE (clear entry) key "undoes" previous key presses — as many as 
you like, right back to the beginning of the expression. Be careful with 
the AC (all clear) key, it resets the Calculator (except for the memory). 

Calculator contains a single memory, which can hold up to 128 char- 
acters, just like the main Calculator display buffer. Whenever you press 
MS (memory store), the enlire contents of the display bullet is saved 
to memory. Then, subsequent presses of the MR (memory restore) key 
append this memon to the end of the current displuv bulfer. provid- 
ing it will all fit. This means that in order for a memory-restore opera- 
tion to work, the current size of the display buffer plus the size of the 
data in memory must be less than 128 characters. You can recall the 
stored data as many times as you like. Clear the memory with, you 
guessed it, the MC (memory clear) kev. 

The EE (for scientific, or engineering, notation) key provides a con- 
venient way to enter very large (or very small) numbers into Calcula- 
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lor. Basic .some limes returns answers in this format, but EE Ids you fil- 
ler them thai way, too. The correct syntax is [number 1 ]K[iuimber2], 
and the operation performed is [numberl] * 10*[numher2]. If [inim- 
ber2] is negative, von create a small number (for example, 1.23E- 
3=0.00123). 

Program Notes 

Most of Calculator, including the table definitions for Buttons, resides 
in the RAM under the Basic ROM. However, three of its routines re- 
side in RAM at 53000, just before Basic ROM. They are the initializer 
routine, which switches the ROM out and the R\M in; the routine that 
actually calls the Basic expression evaiuator; and the routine that in- 
tercepts Basic errors in case you enter your expression wrong. These 
routines are in the CALCPOP program file, while the rest of the code 
is in the program file CALCULATOR. The Buttons table definitions are 
in CALCULATOR. BIN, and the text for the buttons and descriptions 
are in CALCULATOR.TXT. 
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128 Escape Power Keys 

li\ Bill Alaniva 

128 ESCAPE POWER KEYS gives you nine powerful new escape keys 
that add printing power, screen-swapping and double-wide directories 
to your programming arsenal. Table 1 summarizes the sequences and 
their functions. 

Why use escape key sequences to implement new commands? Be- 
cause the escape keys are easy to use. In Immediate mode, just press 
and release the escape key, then press the desired sequence key, I— 9. 
In Program mode, add a PRINT CHR$(27)+T or PRINT CHR${27) 
+CHRS('19) statement to your program to use escape sequence 1. 
(CHRS(27) and CHR$(49) are the character codes for Escape and 1, 
respectively.) 

What's move, using escape key sequences leaves the function keys 
available for other purposes. However, if there are function keys you 
aren't using, it's easy to add escape sequences to them. Escape se- 
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quenccs are easier (o use in Immediate mode ifyou only have lo press 
one key. To redefine a function key, use Basic 7.0's Key command. 
Here's an example: KEY 1, CHR$(27)+CHR$(49). 

Enabling the Program 

Alter activating 128 Escape Power Keys using Menu 128, the pro- 
gram's Basic loader places its machine language in the default location 
4864. Before running the loader, decide if that location is compatible 
with any other machine language programs you'll be running. Ifyou 
want to move the machine language, change variable Al) in line 10 to 
any number that is less than 1 0,000 and divisible by 256. It must be less 
than 10,000 for the directory commands to work properly. Locations 
between 4864 and 7168 are recommended, because they don't require 
moving the start of Basic program space. The machine language must 
be in bank 15 to work properly, and the BANK 15 command in the load- 
er will lake care of that. Ifyou aren't good wiih numbers or don't have 
a calculator, just assign variable AD to a bogus number (such as 100) 
and the loader will give you a list of starting addresses to choose from. 

Once installed, the machine language code will automatically be 
saved. Then you can just BLOAD die machine language into the same 
spot in memoiy when you want to use the new escape keys. For exam- 
ple, ifyou chose location 4864 you would use BLOAD"ESC KEY.ML" 
and NYS 186 1 lo enable i lie new est ape-kev sequences. 

Following the save, die program will ask ifyou want an escape-key 
cheat sheet. Enter Yand you'll be prompted to verify line 480 of the 
program to make sure it will set up the printer for condensed priming. 



Table 1. The nine escape sequences. 






Escape Sequence 




Function Screens 


Modes 


Escape-] Window printer 




40/80-column 


Immediate/Program 


Escapc-'2 l.isi to primer 




40/80-column 


Immediate/Program 


Escape-3 KO-colimm screen 




1 80-column 


Immediate/Program 


Escape-! 80-column screen 




2 80-column 


Immediate/Program 


Escape-5 80-cohmin screen save 




80-column 


Immediate/ Program 


Escapr-lj 40-column screen save 




40-column 


Immediate/Program 


Escape-7 Id-column screen retrieve 


40-column 


Immediate/ Program 


Escape-8 Directory, drive 8 




40/80-column 


Immediate/* 


Escape-'.) Directory, drive 1) 




40/80-column 


Immediate/* 


* Usable in I'ntgifiw mode with the 


approp 


iaU SYS mmwand. 
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( iheck your printer or interface manual for the appropriate sequences. 

II' line 480 will work, make sure the printer is ready and type C to con- 
tinue. You can have the cheat sheet printed out in normal-size print by 
typing N, to bypass line 480. If you need to modify line 480, type M and 
follow the prompts. 

Once the machine language lias been installed, you won't need the 
Basit loader anymore, so type in NEW and you'll be ready to start 
programming. 

The escape sequences are not disabled bv the run-stop/restore key- 
press. However, if you're using 80-column screen 2 and press Run- 
Stop/Restore, you'll return to 80-column screen I. Just press Escape-4 
to get back. To disable 1 28 Escape Power Keys, you must reset the com- 
puter. To restore it after resetting, type in SYS 4864 or your new start- 
ing address. 

Escape Key Functions 

The Window Printer: The Escape-I sequence prints live currently de- 
lined text screen window. Normally, the entire screen is the window, 
but you can use Basic 7.0's Window command to redefine the window 
to whatever portion of the screen you want to print. The window print- 
er works with either the 40- or the 80-column screen. The active screen 
(that is, the one with the cursor) will be primed. 

'fhe Basic loader portion of the program shows how to use the win- 
dow primer by printing out an escape-key cheat sheet that lists all nine 
new escape sequences. Cut it out and keep it near your keyboard for 
quick referencing. You might also want to design a cheat sheet for your 
function-keys or anything else you have a hard lime remembering. The 
window printer makes it easy. 

If you have trouble printing, make sure the printer is online and thai 
its cables are properly connected. If you're still getting poor printouts, 
you can change the secondary address that the program uses when it 
opens a channel to the printer. Remove the REM from line 240, and 
add the new secondary address to the Poke statement. Consult your in- 
terface or printer manual for a list of legal secondary addresses. With- 
out any changes, the program uses a secondary address of zero. 

If you're used to embedding commands in text with your word pro- 
cessor (for such things as colors, bold, underlining and italics), you'll 
be happy to know that 128 Escape Keys will let you embed printer com- 
mands in text screens. If you put the commands on the screen in the 
background color, they won't even show. Be sure to consult your print- 
er manual if you've never used embedded commands before. 
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Basic Lister: The Escape-2 sequence lists the Basic program in mem- 
ory to your printer. It's a handy feature that gets your program on pa- 
per without extra keying. 

80-Column Screens I and 2: Escape sequences 3 and 4 let you select be- 
tween two different 80-column screens. Screen I is (he normal 80-col- 
umn screen. Screen 2 is a completely separate screen that uses the free 
memory in the VDC's exclusive RAM. When you first select screen 2, 
you'll he confronted with Hashing white squares. These are normal and 
won't appear again until after the computer has been turned off and 
back on again. Just do a screen clear and you'll be ready to use the new 
screen. Each screen has its own color memory, so don't be afraid to pro- 
gram in different colors. 

80-Column Screen Saver; The Escape-") sequence is a great addition to 
the two 80-column screens. It copies whichever screen is being used to 
the other. This is useful for saving a screen before pulling down a menu 
or help screen, so that you can restore the screen after you are finished 
with the menu or help screen. You can do just about anything when 
combining escape sequences 3, '1 and 5! 

40-Column Screen Save & Retrieve: The Escapc-fi and -7 .sequences pro- 
vide a screen save and restore feature in 40-Column mode. Both the 
text and color memory are saved, so don't hesitate to change colors be- 
tween saving and restoring. Forty-column text and color is saved to the 
same free memory as 80-column screen 2. This shouldn't be a problem, 
because few programs use both a 40-column screen and two 80-column 
screens. 

Double-wide Directories: The Escape-8 and -9 sequences make excel- 
lenl use of the 80-column screen. With a SYS command, they call up a 
double-wide directory, showing twice as many files, from disk drive 8 or 
9, respectively. Use this with the Escape- 1 window printer sequence to 
gel a director) 1 printout lickety-split. Use the directory sequences in 10- 
Column mode to view a normal-width directory. 

These are the only escape key sequences that won't work in Program 
mode. They simply load the keyboard buffer (the memory where the 
computer records key presses) with the appropriate SYS command to 
get the directory. You can still get double-wide directories in your pro- 
grams by using the appropriate SYS command (normally SYS 51 20,8 or 
9). The 128 Escape Power Keys program can be relocated, which 
changes the SYS command. To gel the new SYS command, either exe- 
cute a double-wide directory in Immediate mode and note the SYS 
command that appears above the directory, or add 256 to your new 
starling address. 
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RUN It Right; C-128 (in 40-Column mode) 

Instant Indexer 

By Mahmood Hasan Merchant 

INDEXER IS A PROGRAM thai I wrote in machine language to help 
me find specific articles from my heap of computet magazine back is- 
sues. Willi lite accompanying Basic program, Customize!", you also can 
adapt it to a variety of' oilier database applications. 

before customizing Indexer, you should understand the basic struc- 
ture of a database program. For an introduction to databases, see "File 
It," by F.llen Rule in the 1991 March/April RUN. 

I designed Indexer with seven fields: article name, author, issue. 
page, computer, category and section. You may have noticed that I 
didn't include a field for the name of the magazine. That's because I 
have many back issues, but (hey are of very few magazines, so I prefer 
to devote an entire file to each. If you'd like to have a magazine field, 
by all means use Custoniizer to create it. 

The Category field can be very useful. When planning your first In- 
dexer file, make a list of the letters you want to assign to each type of 
article, then stick to them throughout that file and others. Some of the 
letters that I use are U for utility, G for game, A for general article, E 
for educational, F for feature, R for review, and so on. 

The Commands 

To loaci and activate Indexer, simply select it using Menu 128. The 
screen will show the number of records free and used, plus a menu of 
commands. Choose a command by pressing the first letter (L for load, 
etc.). All commands i an be aboi led b\ |>i e.s.sing the Escape kcv. 

A sample file named "RUN" is included on this disk for demonstra- 
tion purposes. 

Load: Loads a previously saved database file. Enter a maximum ten- 
character filename when prompted. Pattern matching is also allowed. 
Since all data is saved in program files, the load is very fast on the 1571 
drive. 

II another file is already in memory, a warning appears stating that 
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it will be erased if you load another. To save the file already in memo- 
ry, abort the load command by pressing the Kseape key, (hen save as 
instructed below. 

Find: Searches the database in three different ways, selected from a 
submenu. 

Press A from the submenu to find all of the records with specific data 
in a given field. Then select the field number (1-7) and the data that 
you are looking for. For example, if you wanted to find every article with 
the word "disk" in its title, you would choose field one and type "Disk." 
Indexer would then search all of the records, pulling up those with 
"disk" in the title. The gray right and left arrow keys move you through 
the list of records. 

Press B from the submenu if you want to search using Iwo pieces of 
data. For example, if you wanted to find all utilities for the C>1 28, se- 
lect fields 5 and 6, which call for computer type and category, respec- 
tively. Selecting the And option will bring up all of the files that have 
C-128 in field 5 and Utilities in field (i, whereas the Or option brings 
up records that have either C-128 in field 5 or Utilities in field 6. In an- 
other example, if you wanted to find articles for the C64 or the C-128, 
you would choose field five twice, and enter both computer names. 

Add: With this command you can either arid dala to a file in memo- 
ry or create a new file. Enter the dala for the fields, pressing return each 
time. 

To add to an existing file, load it into memory as described above, 
then select add. Create a new file by selecting Add without loading an 
existing file into memory. 

Correct: Enter the record number that needs to be corrected. Make 
the changes to each field, pressing return after each. When the changes 
have all been made, press escape to return to the Main menu. 

Erase: Enter the record number to be erased. Remaining records are 
adjusted automatically to fill the gap. 

Insert: If you omit an article while entering data, use this option to in- 
sert it in the proper place. Just enter the record number when prompt- 
ed. All records from that number to the end will move one record-spare 
right, then you'll be asked to type the data into the fields. 

View: Choose this command to view the records in a file. Enter a num- 
ber at the prompt and that record will appear. Then use the gray left 
and right arrow keys to move back and forth in the list. 

Save: Pressing S displays the message "SAVINC filename." Press re- 
turn to go ahead with the save or escape to abort. 
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Please note that if yon save a new file under a name that has already 
been used, Indexer will automatically scratch the old file before saving 
the new, so be sure to use a unique name for each new hie. Also note 
that the program automatically appends the prefix INDX. to all file- 
names before saving, to differentiate them from other files on the disk. 

Directory: Lists the disk stattis, and the Indexer data files on disk. 

Customizing 

Customize!" can be used to modify Indexer for other needs. It 
prompts you to enter the filename Indexer.MI., loads the program into 
memory, then offers the following options: 

Directory: All files or only Indexer data file. 1 ; — those with the prefix 
INDX. 

Number of Fields: Minimum of two, maximum of eight. 

Na?nes of Fields: Maximum of eight characters each. 

I Length of Fields: Maximum of 30 characters each. 

After you're satisfied with the changes, enter a filename for saving the 
modified Indexer, 

Before you start entering real data, though, spend some time plan- 
ning the format of your records and testing it. If, after typing a hun- 
dred records, you fell you needed another field, maybe for the section 
of the magazine where an article appears, you'd have to retype all that 
data into the newlv formatted file. ■ 
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8 Programs on this Disk 

From the March/April RUN: 

■ Boosting Basic 

■ Smart Shopper 

■ Super Character Editor 
I Pitch Memorizer 

Plus: Extra Bonus Programs! 

BADE 64 

■ Pop-Up Calculator 

■ 1 28 Power Escape Keys 
I Indexer 



II any manufacturing defect becomes apparent, the defective disk will be replaced free of charge it returned by 
pre-paid mail wittim 30 days of purchase. Send it. with a letter specifying the detect, to: 

ReHUN • 80 Elm Street • Peterborough, NH 03458 

Replacements will not be made H the disk has been altered, repaired or misused through negligence, or it it shows 
signs ol excessive wear or is damaged by equipment. 

fleRUN contains programs taken directly Irom listings prepared to accompany articles in RUN magazine, as well 
as bonus programs. These programs will not run under all system configurations. As your guide, use ihe RUN li 
Right information included with each article. 

The entire contents are copyrighted 1991 by IDG Communications/ Peterborough. Unauthorized duplication is a 
violation of applicable laws. 

it) Copyright 1991 IDG Communications/Peterborough 
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